home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 014 / lrun.arc / LRUN.DOC next >
Text File  |  1984-10-21  |  6KB  |  175 lines
  1.         LRUN.EXE                 VERSION 1.0           September 9, 1984
  2.  
  3.  
  4.  
  5.                               Copyright (C) 1984
  6.                                 Skip Gilbrech
  7.  
  8.         NAME
  9.  
  10.             lrun - load and run an executable member of a .LBR format
  11.                    library file
  12.  
  13.         SYNOPSIS
  14.  
  15.             lrun lib_name[.ext] memb_name[.ext] [args ..]
  16.  
  17.         DESCRIPTION
  18.  
  19.             LRUN loads and runs an executable member of an LBR-format 
  20.             library file by placing a temporary copy of the member 
  21.             (LRUNTEMP.COM or .EXE) in the current directory.  It is a 
  22.             functional copy of a public domain CP/M program, LRUN.COM.
  23.  
  24.             If no drive or directory is specified with the library 
  25.             filename, and the file is not found in the current directory, 
  26.             the PATH environment string will be searched.
  27.  
  28.             If no extension is supplied for the library filename, it will 
  29.             default to "LBR."
  30.  
  31.             If no extension is supplied for the member filename, the 
  32.             library will first be searched for <filename>.COM, and then 
  33.             for <filename>.EXE.  If an extension is supplied, it must be 
  34.             one of the above two, and LRUN will only search for a member 
  35.             file with that extension.
  36.  
  37.             If there isn't enough space in the current directory for the 
  38.             temporary file, a message will be printed and LRUN will exit 
  39.             after deleting what was written of that file.
  40.  
  41.             LRUN will run only under PC or MSDOS Version 2.0 or higher.
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.                                     -- 1 --
  62.  
  63.  
  64.  
  65.  
  66.  
  67.         LRUN.EXE                 VERSION 1.0           September 9, 1984
  68.  
  69.  
  70.  
  71.         FEATURES AND QUIRKS
  72.  
  73.             LRUN should work with library files created under any version 
  74.             of LU. It follows the recent standard laid out in LUDEF5.DOC 
  75.             in determining the validity of the library file with one 
  76.             exception:  If the NAME and EXTENSION portions of the 
  77.             Directory Control Entry are not all blanks, LRUN prints a 
  78.             message, but does not consider it a fatal error, since I have 
  79.             noticed that at least one program in use which creates and
  80.             updates library files does not conform to this rule.
  81.  
  82.             LRUN does not check the CRC of the member file, and in fact, 
  83.             doesn't look at the second 16 bytes of any directory entry.  
  84.             If there is a question about the integrity of the library 
  85.             file or a member of it, the file should be checked using LU 
  86.             with a version number of 3.0 or higher.
  87.  
  88.             LRUN, as far as I can determine, will pass command line 
  89.             parameters to the executed file which are identical to those 
  90.             it would have received if the file had been run directly 
  91.             from DOS command level.  In particular, quoted strings arrive 
  92.             at PSP+80H with their quotes intact.  It seems to be a little 
  93.             known fact that DOS will forgo its special treatment of 
  94.             certain characters (including .;,=+|<>|/[]) if they are 
  95.             enclosed in double quotes, allowing less restricted entry of 
  96.             arbitrary strings from the command line.  Whether the 
  97.             executed program will take advantage of this is, of course, 
  98.             another matter.
  99.  
  100.             The DOS environment is passed unaltered to the program.
  101.  
  102.             A program run using LRUN will have about 12.5K less memory 
  103.             available to it than the same program run from DOS command 
  104.             level.
  105.  
  106.             By the way, LRUN never writes to or alters any library file.
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.                                     -- 2 --
  128.  
  129.  
  130.  
  131.  
  132.  
  133.         LRUN.EXE                 VERSION 1.0           September 9, 1984
  134.  
  135.  
  136.  
  137.         ACKNOWLEDGEMENTS
  138.  
  139.             (The following two paragraphs are excerpted from LU8640.DOC 
  140.             by Paul J. Homchick)
  141.  
  142.             Gary Novosielski designed the LU format and wrote the first 
  143.             programs supporting 'LBR' files.  He has continued to 
  144.             maintain and improve the LU format by distributing a file of 
  145.             the offical LU format definition.  The current version of 
  146.             this definition is contained in LUDEF5.DOC. Interested users 
  147.             are directed to that file for more complete information on 
  148.             the LU format.
  149.  
  150.             This program [LU] had its genesis in the UNIX progam LAR.C.
  151.             LAR was rendered into C that mortal compilers could understand
  152.             by Tom Jennings who renamed the source to LU.C.
  153.             (End of excerpt)
  154.  
  155.             LRUN was written in 'C' and compiled with version 2.12 of the 
  156.             Lattice-C Compiler.  The source code is not being furnished 
  157.             since it wouldn't do anybody much good without numerous 
  158.             changes I had to make in the Lattice 2.12 fork() library 
  159.             routines to get LRUN to work properly. However, if anyone is 
  160.             interested in the source, or in working Lattice fork() 
  161.             functions, they are welcome to contact me.  Also, please 
  162.             contact me to report any bugs or problems.
  163.  
  164.             This document was written using PMATE, and then laboriously 
  165.             formatted using WORDSTAR for lack of an alternative.
  166.  
  167.             LRUN is intended for public domain use and must not be sold.
  168.  
  169.             Skip Gilbrech
  170.             90 Lexington Ave. #10-G
  171.             New York, NY 10016
  172.             212-685-0551
  173.             Compuserve: 71445,534
  174.  
  175.